Inside Macintosh: QuickDraw GX Printing /

Chapter 3 - Page Formatting and Dialog Box Customization / Page Formatting and Dialog Box Customization Reference

Application-Defined Functions / Message Override Functions for Customizing QuickDraw GX Dialog Boxes

GXJobPrintDialog

QuickDraw GX sends the gxJobPrintDialog message when the application calls gxJobPrintDialog to display the Print dialog box. You can install an override function for the gxJobPrintDialog message to modify the behavior or appearance of the Print dialog box. Your override function must match the following formal declaration:

OSErr GXJobPrintDialog (gxDialogResult *aDialogResult);

aDialogResult

On return, a pointer to the selection made by the user in the dialog box.

function result

An error code. The value noErr indicates that the operation was successful.

DESCRIPTION

QuickDraw GX sends the gxJobPrintDialog message when the user selects Print from the File menu and the application subsequently calls the GXJobPrintDialog function to display the Print dialog box on the user's screen.

The default implementation of this message adds the standard printing panels and interface and then displays the dialog box.

You usually override this message to customize the dialog box by adding panels using the GXSetupDialogPanel function.

SPECIAL CONSIDERATIONS

You never send the gxJobPrintDialog message yourself.

You must forward the gxJobPrintDialog message to other message handlers. Add your panels and then forward the message.

RESULT CODES

gxSegmentLoadFailedErr	A required code segment could not be found, or there was not enough memory to load it.
gxPaperTypeNotFound	The user has canceled printing.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help